home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / util / libs / graphics3d.lha / graphics3d.readme < prev    next >
Encoding:
Text File  |  1998-10-24  |  6.6 KB  |  143 lines
  1. Short:      3D graphics shared library V13.01(beta)
  2. Uploader:   p.biancalani@mbox.match.it
  3. Author:     p.biancalani@mbox.match.it
  4. Type:       util/libs
  5. Version        13.01
  6.  
  7. --- English ----
  8. First sorry for my bad English but I don't know it very well.
  9. This is a simple but complete graphic 3D library that use for visualization
  10. only the system library .
  11. Main feature include :
  12.  
  13.    - Visualization of object in systems windows with single buffering.
  14.    - Support of polygons with one, two, tree and four vertex.
  15.    - Use of only fix point value than the math coprocessor is not
  16.      necessary, and is relatively fast on machines us A1200 base too.
  17.    - Implementation of visualization in Wire Frame ,Solid shading and
  18.      Flat shading all simultaneous too and with light source freely 
  19.      placeable .
  20.  
  21. Is tested on (for now): 
  22.    A4000/40 with S.O. 3.0
  23.  
  24. In this version I rewrite totaly the rendering function of library and
  25. I remove the use of blitter and shadow RastPort. 
  26. Now I use to render the scene a chunky buffer and I draw on it only 
  27. with CPU than I use the graphics.library function WritePixelArray8() 
  28. to transfer this on the visualization window.
  29. With this metod I have a big accelleration , on my machines (4000/40
  30. 25MHz 16Mbytes and a PicassoIV SO 3.0) on AGA screen is 2 time faster
  31. and on a Picasso screen almost 3 time.
  32. I thinks that with faster CPU and faster memory this speed up can be
  33. better test it and say to me.
  34.  
  35. But I have leave a version with the old metod of rendering for machines
  36. with 68000 or best but without fast memory (with only chip the new metod 
  37. is slower).
  38. I future it can be possible that I remove this old version than you are
  39. encourage to use the new one.
  40.  
  41. THIS LIBRARY IS A COPYRIGHT OF THE AUTHOR PATRIZIO BIANCALANI AND IS A 
  42. FREEWARE SOFTWARE THAN FREELY USABLE AND DISTRIBUITE BUT WITH ALL FILE OF 
  43. ORIGINAL ARCHIVE AND NOT FOR RESALE OR IT CAN'T BE SOLD, THAN I PROVIDE 
  44. ABSOLUTELY NO WARRANTY FOR THIS SOFTWARE.
  45. IF YOU WANT MODIFY THE ORIGINAL SOURCES TELL ME THIS THAN ,IF IT IS OK, 
  46. I CAN UPDATE ALL ORIGINAL ARCHIVE.
  47. It is very pleasant if you send me an e-mail if you use it.
  48.  
  49. I have included an example write in E (and full commented) and all the source
  50. in C of this library .The executable is 3dlib and it must be in the same
  51. directory of #?.plg files. 
  52.  
  53. The file graphics3d_000_CPU.library is the library for CPU from 68000 with new metod of rendering.
  54. The file graphics3d_000_BLT.library is the library for CPU from 68000 with old metod of rendering.
  55. The file graphics3d_020_CPU.library is the library for CPU from 68020 with new metod of rendering.
  56. The file graphics3d_020_BLT.library is the library for CPU from 68020 with old metod of rendering.
  57. You must rename the correct library to graphics3d.library before use it.
  58.  
  59. Thanks to:
  60.    Maciej R.Gorny for the original routin of engine 3D.
  61.    Alessandro Franchi for beta testing on A1200.
  62.    VolKer Barthelmann author of VBCC the C compiler used by me to write the
  63.    library.
  64.    Andreas Kleinert author of the optimal startupcode for write shared
  65.    library. 
  66.    The authors of Tornado3D for the suggetions to implemented the single
  67.    buffering in a window. 
  68.    All ones that have write an e-mail to me.
  69.  
  70. I'am Patrizio Biancalani from Prato (Italy) and the my E-Mail for
  71. suggestions and signaling is :p.biancalani@mbox.match.it
  72.  
  73. Support site :www.amigaworld.com/support/graphics3dlib/welcome.html
  74.  
  75. --- Italiano ---
  76.  
  77. Questa e' una semplice ma completa libreria grafica 3D che si appoggia
  78. interamente sulle librerie di sistema per la visualizzazione.
  79. Le caratteristiche principali sono:
  80.    
  81.    - Visualizzazione oggetti nelle finestre con single buffering.
  82.    - Supporto di poligoni a uno, due, tre e quattro vertici. 
  83.    - Usa valori solo in fix point quindi il coprocessore non serve
  84.      ed e' relativamente veloce anche su macchine come il A1200 base.
  85.    - Implementa la visualizzazione in Wire Frame ,Solid shading e
  86.      Flat shading anche tutti contemporaneamente e con la fonte di 
  87.      luce posizionabile a piacere.
  88.  
  89. E' stata testata su(per ora):
  90.    A4000/40 con S.O. 3.0
  91.  
  92. In questa versione ho riscritto interamente le funzioni di visualizzazione
  93. e ho rimosso completamente l'uso del blitter e della RastPort nascosta.
  94. Ora uso un chunky buffer per visualizzare e vi disegno solo con la CPU
  95. poi uso la funzione WritePixelArray8() per trasferire il tutto sulla
  96. finestra di visualizzazione.
  97. Con quel sistema si ottiene una grande accellerazione, sulla mia macchina
  98. (4000/40 25MHz 16Mbytes e una PicassoIV) su uno schermo AGA e' 2 volte
  99. piu' veloce e su uno schermo Picasso quasi 3 volte.
  100. Penso che su macchine con CPU e memoria Fast piu' veloce quelle prestazioni
  101. possano ulteriormente migliorare, provate e ditemelo.
  102.  
  103. Ma ho lasciato anche una versione col vecchio metodo di visualizzazione
  104. per macchine con 68000 o migliori ma senza memoria fast (con solo la 
  105. chip la nuova e' piu' lenta).
  106. In futuro e' possibile che elimini questa vecchia versione quindi siete
  107. incoraggiati ad usare solo il nuovo metodo. 
  108.  
  109. QUESTA LIBRERIA E' UN COPYRIGHT DELL'AUTORE PATRIZIO BIANCALANI ED E' UN
  110. FREEWARE SOFTWARE QUINDI LIBERAMENTE DISTRIBUIBILE MA CON TUTTI I FILE
  111. DELL'ARCHIVIO ORIGINALE E NON PER FINI DI LUCRO, IO NON FORNISCO 
  112. ASSOLUTAMENTE ALCUNA GARANZIA SU QUESTO SOFTWARE.
  113. SE VOLETE MODIFICARE I SORGENTI ORIGINALI COMUNICATEMELO, SE E' ACCETTABILE
  114. IO AGGIORNERO' L'ARCHIVIO ORIGINALE.
  115. E' molto gradita la ricezione di un e-mail in caso di uso della libreria. 
  116.  
  117. Ho incluso anche un esempio di uso scritto in E e i sorgenti in C della
  118. libreria.L'eseguibile si chiama 3dlib e deve essere nella stessa directory
  119. dei file #?.plg .
  120.  
  121. Il file graphics3d_000_CPU.library e' per le CPU dal 68000 con nuovo metodo di visualizzazione.
  122. Il file graphics3d_000_BLT.library e' per le CPU dal 68000 con vecchio metodo di visualizzazione.
  123. Il file graphics3d_020_CPU.library e' per le CPU dal 68020 con nuovo metodo di visualizzazione.
  124. Il file graphics3d_020_BLT.library e' per le CPU dal 68020 con vecchio metodo di visualizzazione.
  125. Occorre rinominare la corretta libreria in graphics3d.library prima di
  126. usarla.
  127.  
  128. Si ringrazia :
  129.    Maciej R.Gorny per le routin del motore 3D.
  130.    Alessandro Franchi per il parziale beta testing su A1200.
  131.    VolKer Barthelmann autore del compilatore C VBCC da me usato per
  132.    la stesura della libreria.
  133.    Andreas Kleinert autore dell'ottimo startupcode per le shared
  134.    library. 
  135.    Gli autori di Tornado3D per il suggerimento su come implementare 
  136.    il single buffering in una finestra.
  137.    Tutti quelli che mi hanno scritto.
  138.  
  139. Io sono Patrizio Biancalani residente a Prato Italy e il mio E-Mail per
  140. suggerimenti e segnalazioni e': p.biancalani@mbox.match.it
  141.  
  142. Sito di supporto :www.amigaworld.com/support/graphics3dlib/welcome.html
  143.